| short: |
| de: |
| en: |
| name | type | description | bindable | readOnly | required | defaultValue | localizable |
|---|---|---|---|---|---|---|---|
| cropToParent | brease.enum.CropToParent | Crop list to parent element | false | false | false | none | false |
| dataProvider | ItemCollection | ItemCollection see Datatype | true | false | false | [] | false |
| displaySettings | brease.enum.DropDownDisplaySettings | Defines which elements are displayed on the widget | false | false | false | default | false |
| ellipsis | Boolean | If true, overflow of text is symbolized with an ellipsis. This option has no effect, if wordWrap = true. | false | false | false | false | false |
| enable | Boolean | Initial option to enable widget. | true | false | false | true | false |
| fitHeight2Items | Boolean | If true, the height will fit to the necessary height if the height oft the list is bigger If false, the list uses the configured height | false | false | false | true | false |
| imageAlign | brease.enum.ImagePosition | Position of images relative to text | false | false | false | left | false |
| imagePath | DirectoryPath | Path to the images location (e.g. 'Media/images/'). Names of the images must be given like the index in the dataProvider (e.g. 0.png, 1.png, 2.png) | false | false | false | false | |
| itemHeight | Integer | Height of every item in the List | false | false | false | 40 | false |
| listPosition | brease.enum.Position | Position of opened list relative to ToggleButton. | false | false | false | right | false |
| listWidth | Integer | Width of list and its items when the widget is pressed. | false | false | false | 150 | false |
| maxVisibleEntries | UInteger | An integer to determine max-height of the list | false | false | false | 4 | false |
| multiLine | Boolean | If true, more than one line is possible. Text will wrap when necessary (wordWrap=true) or at line breaks (\n). If false, text will never wrap to the next line. The text continues on the same line. | false | false | false | false | false |
| permissionOperate | RoleCollection | restricts operability to users, which have given roles | false | false | false | false | |
| permissionView | RoleCollection | restricts visibility to users, which have given roles | false | false | false | false | |
| selectedIndex | Integer | Index of the selected item. The first item has index=0 | true | false | false | 0 | false |
| selectedValue | String | Value of the selected item | true | false | false | false | |
| style | StyleReference | reference to a style for this widget type | true | false | false | default | false |
| tabIndex | Integer | sets if a widget should have autofocus enabled (0), the order of the focus (>0), or if autofocus should be disabled (-1) | false | false | false | 0 | false |
| tooltip | String | reference to a tooltip for a widget | false | false | false | true | |
| visible | Boolean | change visibility | true | false | false | true | false |
| wordWrap | Boolean | If true, text will wrap when necessary. | false | false | false | false | false |
| maxHeight | Size | maximum outer height of widget | false | false | false | 0 | false |
| minHeight | Size | minimum outer height of widget | false | false | false | 0 | false |
| maxWidth | Size | maximum outer width of widget | false | false | false | 0 | false |
| minWidth | Size | minimum outer width of widget | false | false | false | 0 | false |
| zIndex | UInteger | The zIndex property specifies the z-order of a widget and its childs. When widgets overlap, z-order determines which one covers the other. A widget with a larger zIndex generally covers a widget with a lower one. The zIndex must be unique within a content. |
false | false | true | false | |
| left | Integer | absolute position measured from left boundary of parent container | false | false | false | false | |
| top | Integer | absolute position measured from top boundary of parent container | false | false | false | false | |
| height | Size | outer height of widget | false | false | false | 30 | false |
| width | Size | outer width of widget | false | false | false | 100 | false |
| name | type | description | defaultValue |
|---|---|---|---|
| cornerRadius | PixelValCollection | Sets the radius of both widget and the drop-down list rounded corners. For further information, please check its type |
0px |
| opacity | Opacity | Opacity of the widget |
1 |
| margin | Margin | Margin of the Widget |
0px |
| shadow | Shadow | Shadow of the Widget |
none |
| backColor | Color | Sets the background color of the widget |
#FFFFFF |
| mouseDownBackColor | Color | Sets the background color of the widget when it is clicked and the drop-down list is displayed |
#DBDBDB |
| disabledBackColor | Color | Sets the background color when the widget is disabled |
#F1F1F1 |
| backGroundGradient | Gradient | Sets the background color of the items not selected as a gradient |
none |
| mouseDownBackGroundGradient | Gradient | ets the text color of the widget when it is clicked and the drop-down list is displayed |
|
| disabledBackGroundGradient | Gradient | Background as a gradient |
|
| borderStyle | BorderStyle | Sets the border style of the widget. For further information, please see its type |
solid |
| borderWidth | PixelValCollection | Sets the width of the border. For further information, please see its type |
2px |
| mouseDownBorderWidth | PixelValCollection | Sets the border with of the widget when it is clicked and the drop-down list is displayed |
2px |
| borderColor | ColorCollection | Sets the border color of both the widget and the drop-down list |
#999999 |
| mouseDownBorderColor | ColorCollection | Sets the border color of the widget when it is clicked and the drop-down list is displayed |
#FD7B01 |
| disabledBorderColor | ColorCollection | Sets the border color when the widget is disabled |
#FFFFFF #C8C8C8 #C8C8C8 #FFFFFF |
| textColor | Color | Sets the color of the text displayed by the widget |
#000000 |
| mouseDownTextColor | Color | Sets the text color of the widget when it is clicked and the drop-down list is displayed |
#000000 |
| disabledTextColor | Color | Sets the color of the text when the widget is disabled |
#989898 |
| padding | Padding | Padding of the Widget |
0 15px 0 15px |
| showOpenIndicator | Boolean | If true the indicator image is displayed |
false |
| openIndicatorColor | Color | Color of the image to open the list |
#000000 |
| mouseDownOpenIndicatorColor | Color | Color of the image to open the list during mouseDown |
#000000 |
| disabledOpenIndicatorColor | Color | Color of the image to open the list when the widget is disabled |
#989898 |
| listPadding | Padding | Padding of the list |
0 15px |
| listBackColor | Color | Sets the background color of the drop-down list |
#FFFFFF |
| listBackGroundGradient | Gradient | Background as a gradient |
|
| activeBackColor | Color | Sets the background color of the selected item |
#ff8800 |
| activeBackGroundGradient | Gradient | Sets the background color of the selected item as a gradient |
|
| listSeparatorColor | Color | Sets the color of the list separator |
#000 |
| listBorderWidth | PixelValCollection | Sets the width of the border around the drop-down list. For further information, please check its type |
2px |
| listTextColor | Color | Sets the color of the text of the drop-down list |
#000000 |
| activeTextColor | Color | Sets the text color of the selected item |
#ffffff |
| textAlign | brease.enum.TextAlign | Alignment of the text |
right |
| fontSize | PixelVal | Fontsize of the text in pixel |
20px |
| fontName | FontName | Fontname of the text |
Arial |
| bold | Boolean | If true font style is bold |
true |
| italic | Boolean | If true font style is italic |
false |
| activeBorderWidth | PixelValCollection | 2px | |
| disabledBorderWidth | PixelValCollection | 2px | |
| rotation | Rotation | 0deg |